<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html version="4.01"><head><title>[retawq] Command-Line Options</title></head>
<body text="#000000" bgcolor="#cccccc" link="#0000ff" vlink="#551a8b"
alink="#551a8b" lang="en">
<center><b><font size="+2">retawq Documentation</font><br><font
size="+1">Command-Line Options</font></b></center>

<ul>
<li><b>--colors=off</b>: don't use colors; if you <i>never</i> want to use
colors, you can set this more easily (permanently) with the <a
href="rtconfig.html">run-time configuration option</a> "colors"</li>
<li><b>--colors=reverse</b>: use black-on-white colors; if you <i>always</i>
want to use colors this way, you can set this more easily (permanently) with
the <a href="rtconfig.html">run-time configuration option</a> "colors"</li>
<li><b>--console</b>: enter console <a href="runmode.html">runmode</a> which
provides a functionality similar to that of the usual, old, shell-like FTP
clients; cf. <a href="custom_conn.html">Custom Connections</a></li>
<li><b>--download=<i>URL</i></b>: download the content from the given <a
href="scheme.html">URL</a>, write it to standard output as it is received and
quit when done. (Technobabble: this option causes the program to enter the
download <a href="runmode.html">runmode</a>.) Cf. the <a
href="key.html">keyboard command</a> "ctrl-d" for more information. Redirection
of the output to a file or to another program and errors are handled as
described for the "--dump" option below.</li>
<li><b>--dump=<i>URL</i></b>: receive the document from the given <a
href="scheme.html">URL</a> completely, then "dump" it to standard output
(layouted) and quit. (Technobabble: this option causes the program to enter the
dump <a href="runmode.html">runmode</a>.) Cf. the <a href="key.html">keyboard
command</a> "d". To store the output in a file, apply the shell redirection
operator "&gt;" as usual, e.g. "retawq --dump=about:retawq &gt;ABOUT". To
redirect the output to another program, apply the shell pipeline operator "|"
as usual, e.g. "retawq --dump=about:retawq | wc --lines". If an error occurs, a
"fatal error" message is printed to standard error (so it's redirectable with
the shell operator "2&gt;"), and the program exits with a non-zero exitcode. -
More detailed control over the output formatting will be possible in a later
version with a "dumpstyle" option.</li>
<li><b>--help</b>, <b>-h</b>: print a help text and quit</li>
<li><b>--resume-session</b>: resume a <a href="session.html">session</a> from
the default session file (usually something like
"/home/<i>your_home</i>/.retawq/session") in curses-like <a
href="runmode.html">runmode</a></li>
<li><b>--resume-session=<i>filename</i></b>: resume a <a
href="session.html">session</a> from the given file in curses-like <a
href="runmode.html">runmode</a></li>
<li><b>--rtcfg=<i>letters</i></b>: which <a href="rtconfig.html">run-time
configuration</a> shall actually be used; the letter "b" stands for "built-in"
(cf. the <a href="ctconfig.html">compile-time configuration option</a>
OPTION_BIRTCFG), the letter "e" for "external file"; you can also combine both
letters or leave them out completely; by default, all "existing" run-time
configurations are used.</li>
<li><b>--userdir=<i>path</i></b>: the path to a retawq user directory which
usually contains at least a <a href="rtconfig.html">run-time configuration</a>
file; cf. the section "User Directory" in the <a href="user_guide.html">user
guide</a>. By default, the user directory is something like
"/home/<i>your_home</i>/.retawq/", depending on the environment variable
"HOME"; this option allows you to use several profiles easily.</li>
<li><b>--version</b>, <b>-v</b>: print a short version information and
quit</li>
</ul>

<p>You can also specify the <a href="scheme.html">URLs</a> of one or two
documents which are then shown (in curses-like <a
href="runmode.html">runmode</a>).</p>

<p><hr>This documentation file is part of version 0.2.6c of <a
href="http://retawq.sourceforge.net/">retawq</a>, a network client created by
<span lang="de">Arne Thoma&szlig;en</span>. retawq is basically released under
certain versions of the GNU General Public License and WITHOUT ANY WARRANTY.
Copyright (C) 2001-2006 <a href="mailto:arne@arne-thomassen.de"><span
lang="de">Arne Thoma&szlig;en</span></a>.</p>
</body></html>
